Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Compatibility Messages

GXPrStlDialog

QuickDraw GX sends the GXPrStlDialog message when an application that supports the Macintosh Printing Manager calls the PrStlDialog function. You can override the GXPrStlDialog message to customize the handling of the PrStlDialog function. Your override of the GXPrStlDialog message must match the following formal declaration:

OSErr MyPrStlDialog (THPrint aTHPrint, Boolean *aBoolean);

aTHPrint

A handle to the print record for this printing operation.

aBoolean

On return, a Boolean value that is true if the user confirmed the dialog box and false if not.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXPrStlDialog message looks for dialog ('DLOG'), item list ('DITL'), and dialog control ('dctl') resources that have the ID -8192 in
your driver resources. If QuickDraw GX does not find resources with this ID, it uses its own default resources to construct and display a style dialog box. Some of the values displayed in the style dialog box are controlled by the customization ('cust') resource.

You can override the GXPrStlDialog message to add any special handling that your printer driver requires with regard to page dimensions and page setup.

SPECIAL CONSIDERATIONS

You never send the GXPrStlDialog message yourself.

You almost always forward the GXPrStlDialog message so that the default implementation can perform its operations.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The PrStlDialog function is described in Inside Macintosh: Imaging With QuickDraw.

The dialog control and customization resources are described in the chapter "Printing Resources" in this book.

The dialog and item list resources are described in Inside Macintosh: Macintosh Toolbox Essentials.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help